home *** CD-ROM | disk | FTP | other *** search
/ Aminet 16 / Aminet 16 (1996)(GTI - Schatztruhe)[!][Dec 1996].iso / Aminet / util / boot / StartupCtrl1_1.lha / StartupControl_V1.1 / StartupControl_V1.1.doc < prev    next >
Text File  |  1996-05-23  |  8KB  |  240 lines
  1.               StartupControl V1.1
  2.           Copyright © 1995-1996 by Dirk Jesse
  3.         this software package is distributed as
  4.                    MAILWARE
  5.                   (23.05.96)
  6.  
  7.  
  8.  
  9. DISCLAIMER:
  10. -----------
  11.  
  12. The author cannot be  held  liable for the  suitability  or  accuracy of
  13. this  documentation and/or the program it describes. Any damage directly
  14. or indirectly caused by  the use or misuse of  this documentation and/or
  15. the program it describes is the sole  responsibility of the user her/him
  16. self.
  17.  
  18.  
  19.  
  20. COPYRIGHT & DISTRIBUTION:
  21. -------------------------
  22.  
  23. The program and all related files are freely distributable, but are also
  24. copyright (c) by Dirk Jesse.  They may be freely  distributed as long as
  25. no more than the nominal fee is charged to cover time and copying costs.
  26.  
  27. No commercial usage is permitted without the written permission from the
  28. author.  Everything  in  this  distribution  must be  kept  togehter, in
  29. original unmodified form.
  30.  
  31.     !! ATTENTION - SOFTWARE-STATUS OF STARTUPCONTROL HAS CHANGED !!
  32.  
  33. Since this program is released  as  MAILWARE with version V1.1, you have
  34. to send an E-Mail  to  the author in order to honour his work if you use
  35. StartupControl. If you ain`t able to do so, please send  a nice postcard
  36. from your hometown.
  37.  
  38. This distribution contains the following files:
  39.  
  40.      StartupControl_V1.1
  41.      StartupControl.doc
  42.      StartupControl.doc.info
  43.      StartupControl.guide
  44.      StartupControl.guide.info
  45.  
  46. Fred  Fish  and  the  makers  of  the  "Aminet PD Series"  have  special
  47. permission to distribute this software package on their CD`s.
  48.  
  49.  
  50.  
  51. INTRODUCTION:
  52. -------------
  53.  
  54. PLEASE READ THIS DOCUMENTATION CAREFULLY BEFORE USING STARTUPCONTROL FOR
  55. THE  FIRST  TIME  TO   UNDERSTAND  WHAT   THE   PROGRAM  DOES  AND  WHY!
  56.  
  57. StartupControl is an utility that simply gives you some more contol over
  58. the boot  sequence of your dream-machine.  Its usual place is on the top
  59. of the  startup-sequence.  From there, StartupControl will  allow you to
  60. disable execution  of User-Startup  and/or all  files in your WBStartup-
  61. directory.  If you have OS2.1 or higher you  can also  disable installed
  62. monitordrivers to get a pure  PAL-system that doesn`t damage a connected
  63. TV-set, which only works with 15kHz  modes.  To complete  the variety of
  64. functions  you  can  open a  Shell  window or  even  directly  execute a
  65. scriptfile or run an executable from StartupControl via Asl- or ReqTools
  66. filerequester
  67.  
  68. The idea for StartupControl came from Lars Eilebrechts "ShadowStart 1.2"
  69. which  offers similar "disable"  functions,  but leaves out Script-,Exe-
  70. and PAL-options.  So I decided to  write  StartupControl and that`s what
  71. you got on your screen right now. You surely will find some similarities
  72. to ShadowStart in this program but why inventing the wheel twice? I like
  73. the  way  ShadowStart does it`s job and so I arranged  StartupControl in
  74. same way.  When activating StartupControl it opens a requester where you
  75. can choose the way things will go.
  76.  
  77.  
  78.  
  79. REQUIREMENTS:
  80. -------------
  81.  
  82.     - Any Amiga with installed OS2.04 (V37) or higher
  83.  
  84.     - installed AmigaDos commands: execute, run, newshell
  85.  
  86.     - reqtools.library, if you want to use ReqTools-Filerequester
  87.  
  88.     - Workbench 2.1 or better for using PAL-Option
  89.  
  90.  
  91.  
  92. INSTALLATION:
  93. -------------
  94.  
  95.     - as  StartupControl is a  simple  command I recommend to copy it to
  96.       your "C:" directory,  but of course you can place it  wherever you
  97.       want.
  98.  
  99.     - Grab your favourite editor and load your "S:Startup-sequence". Now
  100.       insert the following line AFTER the SetPatch-command:
  101.  
  102.       "<path>StartupControl_V1.1".
  103.  
  104.     - As I remember - that`s all...
  105.  
  106.  
  107. I decided to  add a commandline option to use  this  wonderful ReqTools-
  108. filerequester  when  selecting  files.  So, if you  want to use it, just
  109. write:
  110.  
  111.     Assign ENV: ENVARC:
  112.     <path>Startupcontrol_V1.1 -r
  113.  
  114.     or start "RTPatch" in front of StartupControl...
  115.     (RTPatch contains  to the ReqTools-Package by Nico François and
  116.     can  be  found in  Aminet or almost  any  other  PD-Collection)
  117.  
  118.  
  119. The  "Assign" has to be done, because reqtools.library ties  to load its
  120. preferences file from  ENV:. If you don`t assign  ENV:, reqtools.library
  121. will use its defauts and  popup a lousy requester, telling you, that ENV
  122. wasn`t found.  It should be assigned  to ENVARC:, because StartupControl
  123. runs very early in  startup process  when your contents of ENVARC: isn`t
  124. copied to RAM:ENV yet.
  125.  
  126.  
  127. USAGE:
  128. ------
  129.  
  130. When StartupControl is installed  correctly, it is  easy to  use. Simply
  131. hold  down  left or right  ALT key or press the left mousebutton after a
  132. reset or after switching on your  machine and StartupControl will open a
  133. nice requester  offering a  variety of  functions.  Simply select one of
  134. these buttons:
  135.  
  136.     WB+User   ->  disables both, WBStartup and User-Startup
  137.  
  138.     WB        ->  only disables WBStartup
  139.  
  140.     User      ->  only disables User-Startup
  141.  
  142.     Shell     ->  opens a shell window, startup-sequence is paused until
  143.           you send a BREAK to StartupControl by typing "BREAK 1"
  144.           in your shell-window.
  145.  
  146.     Script    ->  opens  a  filerequester to  execute a  scriptfile  and
  147.           returns  to  the  StartupControl-Menu when  script has
  148.           finished
  149.  
  150.     Exe       ->  opens  a filerequester  to  run an  executable file in
  151.           background and returns to the StartupControl-Menu.
  152.  
  153.     PAL only  ->  disables an installed  monitordriver to force PAL-mode
  154.           only available with Workbench 2.1+
  155.  
  156.     Cancel    ->  leave StartupControl, startup-sequence is continued
  157.  
  158.  
  159. WHAT DOES STARTUPCONTROL TO DISABLE FILES OR DIRECTORIES?
  160.  
  161. StartupControl  renames the "WBStartup" directory, "S:User-startup" file
  162. or  "Devs:Monitors"  directory  to  prevent  them  from  being  executed
  163. ("name" is renamed to "#name"). After  changing names files stay renamed
  164. until next reset.  To get  back  their original  names  after  disabling
  165. them,  you  can  rename  them  yourself  or  run  StartupControl  again.
  166. If you boot your  machine without  activating  StartupControl  all files
  167. and directories are automaticly  set  to their original names. So if you
  168. wont disable something, there will be no change.
  169.  
  170. When opening a shell window the  Startup-sequence is paused. To continue
  171. executing  startup-sequence,  send a "break"  command to StartupControl.
  172. If StartupControl was started  directly  after SetPatch,  it normaly has
  173. process  number 1.  Typing  "Break 1" in  your  shell-window  will  quit
  174. StartupControl  and  execution  of  startup-sequence  will be continued.
  175. Don`t forget to close the shell  window to allow  workbench to reset its
  176. screen to its needs.
  177.  
  178. When using  the SCRIPT or EXE option, the  program  returns to the menu,
  179. after execution  of a  selected  file to give  you the possibility to do
  180. further changes like opening  a  hell.  This can  be very useful, if you
  181. want to run large, memory-hungry applications  like games and demos. So,
  182. you can setup a  small  environment  via  scriptfile and then watch your
  183. favrourite amiga-demos from a shell-window.
  184.  
  185.  
  186.  
  187. RESTRICTIONS: When  pressing  the  ALT  key  too  early  during a reset,
  188.           StartupControl  maybe  don`t  realizes  that  the  key was
  189.           pressed.
  190.           This can happen, because the  harware keybuffer is cleared
  191.           during  reset,  so  the  keycode  is  already  lost before
  192.           StartupControl is executed.
  193.  
  194.  
  195.  
  196.  
  197. HISTORY:
  198. --------
  199.  
  200. V1.1
  201.  - EXE-Option added
  202.  - after  SCRIPT  and  EXE option, StartupControl  returns  to its  menu
  203.    to allow further selections
  204.  - there  are no longer two  versions for OS2.0 and OS2.1+ (two in one!)
  205.  - ReqTools support and commandline option added
  206.  - StartupControl sets  CurrentDir to  ProgDir to help  programs to find
  207.    their stuff
  208.  - minor code changes
  209.  
  210. V1.0
  211.  - first public release
  212.  
  213.  
  214.  
  215. AUTHOR`S ADRESS:
  216. ----------------
  217.  
  218. If you have any suggestions, ideas or bug-reports, please send a mail to
  219. this adress (E-Mails prefered).
  220.  
  221.  
  222.  
  223.       Dirk Jesse
  224.       Promenadenstraße 11
  225.       02827 Görlitz
  226.       GERMANY
  227.  
  228.       E-Mail:  djesse@rcs.urz.tu-dresden.de
  229.  
  230.  
  231.  
  232. Other programs I`ve written:
  233.  
  234.       SAMPack  convert and compress really large 8bit IFF, WAVE, VOICE,
  235.            RAW samples
  236.            Aminet: /mus/edit/smp_v132.lha
  237.  
  238.       ...
  239.  
  240.